home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / PROGRAMM / DB_CLIPP / 0277.ZIP / LIST60G.DOC < prev    next >
Text File  |  1986-09-07  |  30KB  |  901 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                         LIST Version 6.0g
  7.                 (c) Copyright Vernon D. Buerg 1986
  8.  
  9.                         September 7, 1986
  10.  
  11.  
  12.  
  13.                         Table of Contents
  14.                         -----------------
  15.  
  16.                 Description of use ...............  1
  17.  
  18.                 Keys and commands ................  3
  19.  
  20.                 Positioning to lines .............  5
  21.  
  22.                 Display format ...................  6
  23.                  Status line .....................  6
  24.                  Command line ....................  7
  25.  
  26.                 Screen colors ....................  8
  27.                  Cloning procedure ...............  9
  28.                  DEBUG Information ............... 10
  29.  
  30.                 Searching for text................ 11
  31.  
  32.                 Filtering ........................ 12
  33.  
  34.                 Update history ................... 13
  35.  
  36.                 Restrictions ..................... 14
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                                                         LIST     Page 1
  61.  
  62.  Command  LIST
  63.  -------------
  64.  
  65.  
  66.  Purpose:
  67.            You use LIST to display  files on your monitor, line  by line
  68.         with the aid of scrolling, positioning and filtering commands.
  69.  
  70.  
  71.  Format:
  72.                  LIST  [d:][path]filename[.ext]
  73.  
  74.  
  75.  Remarks:
  76.            You may rename the program file to any convenient name,  such
  77.         as L.COM, READ.COM, or LIST.COM.
  78.  
  79.            Using  LIST  is  fairly  easy.   You  type  the  command LIST
  80.         followed by  the name  of the  file that  you want  to see.  For
  81.         example: LIST CONFIG.SYS would display the file CONFIG.SYS.
  82.  
  83.            Once the file  is displayed on  your screen, you  may use the
  84.         cursor positioning keys to  move around and see  different parts
  85.         of the file.  For example,  when LIST first starts, you  see the
  86.         first 23 lines of the file.  To see the next 23 lines, or  page,
  87.         press the PgDn key.   The PgUp key moves  you back one page  and
  88.         shows you the  previous 23 lines.   The up-arrow and  down-arrow
  89.         keys move the one line at a time.  When you are finished,  press
  90.         the ESCape key and you are returned to the DOS prompt.
  91.  
  92.            The "filename" is optional.  If omitted, you are prompted  to
  93.         to enter  a filename.   You may  include drive,  path, and  wild
  94.         cards in the file name.   The first file which matches  the name
  95.         is displayed.  After that file is displayed, the next file which
  96.         matches the "filename" may be displayed, too.
  97.  
  98.            You may also use LIST  to display piped or redirected  files.
  99.         If you are unfamiliar with these, you may skip to the next page.
  100.         To display a redirected file, use a < (less than symbol)  before
  101.         the name  of the  file. and  add the  /S parameter  to the  LIST
  102.         command.  For example,
  103.  
  104.                 dir a: >xyz
  105.                 list <xyz /s
  106.  
  107.         To display a piped file, omit the filename but supply the /S.
  108.  
  109.                 dir a: | list /s
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.                                                         LIST     Page 2
  121.  
  122.  
  123.  
  124.            Because  files  contain  different  kinds  of data, there are
  125.         several commands  to tell  LIST how  to display  the data.   The
  126.         process that LIST uses to make the file data readable is  called
  127.         filtering.  The filters in LIST can:
  128.  
  129.             - replace non-text and control characters with blanks
  130.             - expand TAB characters
  131.             - display line drawing characters
  132.             - change 8-bit (W*) data to readable 7-bit text
  133.             - display the hexidecimal values for each character
  134.  
  135.  
  136.            LIST was  designed to  display ASCII  files.  That  is, files
  137.         which  contain  text  and  not  binary  or  control codes.  Text
  138.         characters usually  range from  a value  of 32  to 127.  To view
  139.         binary  files  (COM,  EXE,  etc),  the  alt-H (hex dump display)
  140.         command is available.
  141.  
  142.  
  143.            Characters  below  32  (a  blank)  are  replaced with a funny
  144.         character to indicate that a non-displayable character has  been
  145.         encountered.  This  character is  an upside-down  question mark.
  146.         Characters above 127 may be valid graphic characters, and may be
  147.         displayed  if  the  '8'  command  is  in effect.  To insure that
  148.         characters above ASCII value 127 are not displayed, use the  '7'
  149.         command.
  150.  
  151.  
  152.            The top  line of  the display  gives the  file name,  current
  153.         right  scroll  offset,  and  the  file's creation date and time.
  154.         Optionally, a ruler  may be displayed  on the top  line by using
  155.         the alt-R keys.
  156.  
  157.  
  158.            The  file  is  displayed  with  one  logical  record  on each
  159.         80-column display line.   A logical record  ends in a  linefeed.
  160.         The maximum logical record may  be 256 characters long.  If  the
  161.         record exceeds 80  characters, you may  view the portion  beyond
  162.         the 80 columns  by using the  scroll right command,  or by using
  163.         the  Wrap  feature.   The  Wrap  command  toggles  ON or OFF the
  164.         wrapping  of  lines  longer  than  80 characters.  With Wrap on,
  165.         lines are displayed in their entirety, 80 characters per display
  166.         line.  The scroll -left  and -right functions are  disabled when
  167.         Wrap is ON.
  168.  
  169.  
  170.            The file may  be PRINTed as  it it displayed.   The P command
  171.         toggles  the  printer  on  or  off.   When  first entered, the P
  172.         command causes the current screen  to be printed.  As new  lines
  173.         are displayed, they too are printed.  Printing may be stopped by
  174.         entering another P command.  The PrtSc key may also be used, but
  175.         the title and prompt lines will be printed with the lines of the
  176.         file.  Empty lines  cause a line  to be skipped  on the printer.
  177.         The letter P  is displayed in  column 80 of  the top line  while
  178.         printing.
  179.  
  180.                                                         LIST     Page 3
  181.  
  182.  Key functions and Commands
  183.  --------------------------
  184.  
  185.         On the COMMAND line, enter a letter or control key:
  186.  
  187.         Control key      Function
  188.         -----------     -------------------------------
  189.         left arrow      scroll left 20 columns
  190.         right arrow     scroll right 20 columns
  191.         up arrow        up one (previous) line
  192.         down arrow      down one (next) line
  193.  
  194.         Enter           continue to next page
  195.         END             position to end of file (bottom)
  196.         ESCape          Display next matching file
  197.         HOME            restart from first line (top)
  198.         PgUp            scroll up one page, 23 lines
  199.         PgDn            scroll down one page, 23 lines
  200.  
  201.  
  202.         Letter(s)     Default   Function
  203.         ---------     -------   ------------------------
  204.         A                       find next occurance of 'text' (Again)
  205.         B                       skip to end of file (Bottom)
  206.         C               off     toggles Closing of (shared) files
  207.         D                       scroll Down one page
  208.         F                       Find 'text' regardless of case
  209.         G                       Get new filename/filespec (also alt-F)
  210.         H or ?                  list commands (Help)
  211.         K               off     toggle Keyboard flush; if on, commands
  212.                                 may be queued up by holding a key down
  213.         L                       scroll Left 20 columns
  214.         M               on      toggle test for display retrace, if on
  215.                                 the display is faster but may flicker;
  216.                                 not applicable to monochrome monitors
  217.         N                       down one (Next) line
  218.         P               off     toggle Printer on or off
  219.         Q                       Quit, display next matching file
  220.         R                       scroll Right 20 columns
  221.         S                       Scan for exact text match, case dependent
  222.         T                       restart from first line (Top)
  223.         U                       scroll Up one page (23 lines)
  224.         W               off     toggle Wrap of lines over 80 chars
  225.         X                       terminate, clear screen and eXit to DOS
  226.  
  227.         7               off     turn off high bit (non-graphics only)
  228.         8               on      leave high bit on (graphics)
  229.         *               off     toggles special * document filtering
  230.  
  231.         +                       position a given number of lines forwards
  232.         -                       position a given number of lines backwards
  233.  
  234.         \text                   Find 'text' regardless of case
  235.         /text                   Scan for exact text match
  236.  
  237.  
  238.  
  239.  
  240.                                                         LIST     Page 4
  241.  
  242.  Key functions and Commands (cont.)
  243.  --------------------------
  244.  
  245.  
  246.     Control key      Function
  247.     -----------     -------------------------------------------
  248.      F1              Help - display summary of commands
  249.      F3              Find next occurrance of text after Scan or Find
  250.      F10             Exit to DOS with clear screen and cursor last line
  251.  
  252.      F2              change background color for Find/Scan text
  253.      F4              change foreground color for Find/Scan text
  254.  
  255.      F5              change background color for main body of display
  256.      F6              change foreground color for main body of display
  257.  
  258.      F7              change background color for top and bottom lines
  259.      F8              change foreground color for top and bottom lines
  260.  
  261.  
  262.      ctl-HOME        positions to a specific line number
  263.      ctl-PgUp        restart from first line (TOP)
  264.      ctl-PgDn        skip to end of file (BOTTOM)
  265.      ctl-left-arrow  reset scroll to column 1
  266.  
  267.  
  268.      alt-A           toggle Apxcore(on), DesqView/DoubleDos(off-default) use
  269.  
  270.      alt-C           clone LIST.COM, change colors or options
  271.                      permanently in program file
  272.  
  273.      alt-E           toggle 25/43 line display (does test for EGA)
  274.  
  275.      alt-F           prompt for new Filespec or filename to display
  276.                      entering a leading asterisk (*) may be obscured
  277.                      by some console enhancers or utilities, so enter
  278.                      two asterisks, e.g. **.doc
  279.  
  280.      alt-H           toggles hex dump formatted display
  281.  
  282.      alt-P           toggle preloading of files, default is on
  283.                      When the file is pre-loaded, the ending line
  284.                      line number becomes known.
  285.  
  286.      alt-R           toggles display of a ruler on the top line
  287.  
  288.      alt-S           toggles file Sharing option, when off
  289.                      files remain open until program termination
  290.  
  291.      alt-T           toggles expansion of TAB control characters, the
  292.                      tab columns are a multiple of 8, i.e. 1,9,17, etc.
  293.                      The default is to expand TABs.
  294.  
  295.      alt-W           toggles split screen; when ON, the top half of
  296.                      the screen is frozen. Further scrolling occurs
  297.                      only in the bottom half of the screen (window)
  298.                      until the alt-W keys are used again.
  299.  
  300.                                                         LIST     Page 5
  301.  
  302.  
  303.  Positioning to Lines
  304.  --------------------
  305.  
  306.            Each displayable line of the file is assigned a line  number.
  307.         The first line is assigned line number 1.  The highest allowable
  308.         line  number  is  65535.   In  order  to determine the last line
  309.         number, the  entire file  must be  read.  For  this reason,  the
  310.         first time that the END (bottom) command is issued, it will take
  311.         longer  to  process.   This  is  not  necessary  if  the file is
  312.         preloaded.
  313.  
  314.            If the  Wrap option  is in  effect, there  is one line number
  315.         required for each 80 bytes of the file records.
  316.  
  317.            If the hex dump option is in effect, there is one line number
  318.         required for each 16 bytes of the file.
  319.  
  320.            You  may  position  to  a  specific  line number by using the
  321.         c-Home, Ctrl key  and Home key,  or the #  key.  When c-Home  is
  322.         entered, you are prompted for the line number.  Enter the 1 to 5
  323.         digit line number.   The display will  now begin with  that line
  324.         number at the top of the screen.
  325.  
  326.            To position forward or backward, you may use the + (plus), or
  327.         - (minus) keys.  You are  prompted to enter the number  of lines
  328.         to be skipped.  The display resumes at the line number shown  on
  329.         the top (status)  line, plus or  minus the number  of lines that
  330.         you specified.
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.                                                         LIST     Page 6
  361.  
  362.  Display format
  363.  --------------
  364.  
  365.            The monitor display is defined in terms of lines and columns.
  366.         A typical monitor can display 25 lines of 80 columns each.  LIST
  367.         attempts to use the number of lines and  columns for the monitor
  368.         mode in use.  For example, if the monitor is in 40 column  mode,
  369.         LIST displays only 40 characters per line.
  370.  
  371.            The top line of the  display is called  the Status line.  The
  372.         bottom line is called the Command line.  The remaining lines are
  373.         called the  primary  display  window,  and are usually lines two
  374.         through 24.
  375.  
  376.  
  377.  Status line format
  378.  ------------------
  379.  
  380.     The Status line has the following format:
  381.  
  382.      LIST   lllll nnnnnnn +sss mm/dd/yy hh:mm  - filename
  383.  
  384.     where,
  385.  
  386.         'LIST'     is the name of this program
  387.  
  388.         'lllllll'  is the line number of the first line in the
  389.                    display window (usually on line 2)
  390.  
  391.         'nnnnnnn'  is the line number of the last record, if known
  392.  
  393.         '+sss'     if displayed, this is the Scroll amount, in
  394.                    multiples of 20, corresponding to the number
  395.                    of columns that the display has been shifted
  396.                    to the right to view records longer than 80
  397.  
  398.         'mm/dd/yy' is the file's creation date
  399.         'hh:mm'    is the file's creation time
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.                                                         LIST     Page 7
  421.  
  422.  Command line format
  423.  -------------------
  424.  
  425.     The Command line has the following format:
  426.  
  427.       command message ______ St: dbkmpswt Keys: arrows X=exit ?=Help
  428.  
  429.     where,
  430.  
  431.       'command' indicates the current process:
  432.  
  433.           'Command'   you are being asked to enter a command
  434.                        enter the letter, or press the keys for
  435.                        the action to perform
  436.  
  437.           'Reading '   the file data is being read
  438.           'Filter  '   the file data is being formatted for display
  439.           'Scanning'   the Scan/Find text is being searched for
  440.  
  441.           'Scan   '   you are being asked to enter text to locate
  442.           'Find   '   in the file, up to 31 characters may be entered
  443.  
  444.           '# lines?'   you are being asked to enter a 1 to 5 digit
  445.                        number that is the amount of lines to skip
  446.  
  447.           'Line #? '   you are being asked to enter a 1 to 5 digit
  448.                        line number to which the display is to be
  449.                        positioned
  450.  
  451.  
  452.         'message' may be one of:
  453.  
  454.           '*** Text not found ***'
  455.            the Scan/Text was not found in the file
  456.  
  457.           '   *** Top of file ***'
  458.            the first line of the file is being displayed
  459.  
  460.           '   *** End-of-file ***'
  461.            the last line of the file is being displayed
  462.  
  463.         St: indicate status of toggles, lower case means off:
  464.  
  465.         'D'       indicates that the hex Dump display option is in use
  466.         'b'       indicates whether the 7-bit, 8-bit, or *-option is
  467.                   in use
  468.         'K'       indicates that the Keyboard flush option is in use
  469.         'M'       indicates that tests for monitor retrace are not made
  470.         'P'       indicates that Print is in use
  471.         'C'       indicates that the C (file sharing) is in use
  472.         'W'       indicates that the Wrap mode is in effect
  473.         'T'       indicates that TAB characters are expanded
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.                                                         LIST     Page 8
  481.  
  482.  Screen colors
  483.  -------------
  484.  
  485.         The screen's lines may be in any of three different colors:
  486.  
  487.                 - the 'special' color for the top status line and the
  488.                   bottom command line
  489.                 - the 'normal' color for the file's text
  490.                 - the 'bright' color for lines with Find/Scan text
  491.  
  492.            There is a pair of function keys assigned to each color.  You
  493.         may  use  these  function  keys  to  change  the  background and
  494.         foreground  colors  temporarily.   To  make  the  color  changes
  495.         permanent, you may use the cloning command (alt-C), or use DEBUG
  496.         to modify the program file.
  497.  
  498.            The colors used  for displaying the  titles and main  body of
  499.         text  may  be  changed  temporarily  or  permanently.  To make a
  500.         permanent  change,  the  cloning  command  alt-C  is  used.   It
  501.         requires that the LIST.COM program file be on the current  drive
  502.         and in the current directory.
  503.  
  504.            The border is not  changed.  The foreground color  applies to
  505.         the characters displayed.
  506.  
  507.  
  508.         The color attributes may be changed by using these function keys:
  509.  
  510.           For the main body of text:
  511.  
  512.             F5 - background color
  513.             F6 - foreground color
  514.  
  515.           For the top and bottom lines:
  516.  
  517.             F7 - background color
  518.             F8 - foreground color
  519.  
  520.           For the line with Find/Scan text:
  521.  
  522.             F2 - background color
  523.             F4 - foreground
  524.  
  525.            Once you  have decided  upon the  colors, use  the alt-C  key
  526.         combination to change the LIST.COM program file.
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.                                                         LIST     Page 9
  541.  
  542.  Cloning procedure
  543.  -----------------
  544.  
  545.            The screen colors, the display retrace testing (M), the  file
  546.         closing (C) and ruler (alt-R) options may be permanently set  in
  547.         the program by using the alt-C cloning function.
  548.  
  549.            For  cloning  to  take  effect,  the  program  must be called
  550.         LIST.COM and it must be on the current drive and in the  current
  551.         directory.  There are two versions of the LIST COM file.  One is
  552.         the normal  program.  The  other, which  contains an  'S' as the
  553.         last letter of  the file name,  is a slightly  smaller file that
  554.         excludes  the  Help  screen.   You  may  use either COM file for
  555.         cloning.
  556.  
  557.            The clonable options (command toggles) are:
  558.  
  559.              M      =  Mono monitor, affects retrace testing,
  560.              C      =  file(s) are shared,
  561.              W      =  Wrap long lines
  562.              8/7/*  =  display all 256 values, or 7-bit, or special cases
  563.              K      =  flush Keyboard each time a command is read
  564.              alt-H  =  hex dump display, like the DEBUG format
  565.              alt-R  =  use ruler on top line,
  566.              alt-T  =  toggle expansion of TAB characters
  567.  
  568.            These clonable options have no status line indications:
  569.  
  570.              alt-A = set on if using Apxcore, off if using Double Dos
  571.              alt-P = set on to force preloading (reading) of entire
  572.                      file before any lines are displayed, default is on.
  573.  
  574.  
  575. |       Note: Be sure you have no other copies of LIST.COM which
  576. |       are accessible (because of a filepath type of utility).
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.                                                         LIST     Page 10
  601.  
  602.  
  603.  DEBUG Information
  604.  -----------------
  605.  
  606.            An alternative to cloning is  to use DEBUG to make  permanent
  607.         changes.  Here is a list of key items and their addresses:
  608.  
  609.            0122 - special lines 1 and 25 colors, default is 01 (blue)
  610.                   Refer to a technical reference guide for the
  611.                   attribute values for the colors that you want.
  612.            0124 - normal lines 2 thru 24 colors, default is 02 (green)
  613.            0126 - bright color for Find/Scan, default is 0C (bright red)
  614.            0128 - options; bits 0 through 6
  615.                    MRSD WHK*  M = mono, retrace testing if off, x'01'
  616.                               R = ruler, x'02'
  617.                               S = shared, x'04'
  618.                               D = hex display, x'08'
  619.                               W = wrap mode, x'10'
  620.                               H = hi-bit on, x'20'
  621.                               K = kybd flush, x'40'
  622.                               * = special document filtering, x'80'
  623.  
  624.            0129 - clonable options, not indicated:
  625.                    .PAT. .... P = Preload file if on (default) x'02'
  626.                               A = Apxcore if on, TV/DD/DV if off, x'04,
  627.                                   default is for Topview/Double DOS use
  628.                               T = expand TABs if on (default), x'08
  629.  
  630.                   By specifying  the bit  value, the  option is enabled.
  631.                   For example, to enable  Shared and Retrace, specify  a
  632.                   hex value of the sum, or 01+04 = 05.
  633.  
  634.  
  635.         When the Find/Scan command is used, the next line which contains
  636.         that text is highlighted using the 'bright' color, and is placed
  637.         in row 11 of the screen.  You can change the row by altering the
  638.         byte at location 12A which is normally '0A'.
  639.  
  640.            The letters and command keys may also be changed.  There  are
  641.         two tables involved: WHAT and WHERE.  The WHAT table contains  a
  642.         list of  one-byte keyboard  codes.  The  WHERE table  contains a
  643.         list  of  two-byte  matching  addresses.   If you really want to
  644.         change the codes, here are the DEBUG addresses:
  645.  
  646.            0359 - *WHAT* eye catcher
  647.            035F - list of one byte command letters and codes
  648.  
  649.            039F - *WHERE* eye catcher
  650.            03A6 - list of two byte addresses of processing routines
  651.  
  652.         NOTE: These DEBUG addresses are version dependent.
  653.         ==================================================
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.                                                         LIST     Page 11
  661.  
  662.  Scanning for text
  663.  -----------------
  664.  
  665.  
  666.            You may  use Find  (\) to  search for  text regardless of the
  667.         case, or you may use Scan (/) to find an exact match.
  668.  
  669.            To scan for a character string, type a slash (/) followed  by
  670.         one or more (up to 31)  characters.  The scan text, but not  the
  671.         slash,  is  displayed  on  the  command  line.  The scan is case
  672.         sensitive.  That is, lower case scan text will only match  lower
  673.         lower case file text.
  674.  
  675.            While  the  program  is  searching  for  the text, the bottom
  676.         display line  is changed  to say  "Scanning".  Pressing  any key
  677.         while the search  is in progress  will terminate the  search and
  678.         display the message 'Text not found' on the bottom line.
  679.  
  680.            If the text is found, the line containing it is displayed  as
  681.         a high-intensity line (bright color).
  682.  
  683.            If the text is NOT found, the bottom line (25) is changed  to
  684.         say '*** text not found ***', and the display remains unchanged.
  685.  
  686.            To find the next occurrance of the same text, use the  A)gain
  687.         command, or press the F3 key.
  688.  
  689.            If the  PCED keyboard  enhancement program  is installed, the
  690.         up/down cursor keys  may be used  to recall and  edit previously
  691.         entered Scan/Find text.
  692.  
  693.            In a shared file environment, if the file changes while being
  694.         listed,  the  file  position  may  become invalid.  Use the HOME
  695.         command  to  insure  proper  file  synchronization, or use the C
  696.         (shared) option.
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.                                                         LIST     Page 12
  721.  
  722.  Filtering
  723.  ---------
  724.  
  725.            Filtering is the term used to describe the process that  LIST
  726.         uses to  format file  data for  displaying on  a monitor.  After
  727.         data  is  read  from  a  file,  it  is  filtered.  The method of
  728.         filtering depends upon the options in effect.
  729.  
  730.            For a typical  ASCII text file,  the filter removes  carriage
  731.         return and line feed characters, and expands TAB characters.
  732.  
  733.            The  7,  8,  and  *  (asterisk)  commands  determine  whether
  734.         characters above ASCII-127 are displayed.  If the hi-bit  option
  735.         is off (7  command), the filter  strips the high  order bit from
  736.         each character.   If the  hi-bit option  is on  (8 command), all
  737.         characters, including  graphic characters  above ASCII-127,  are
  738.         displayed.
  739.  
  740.            The * (asterisk) command displays only ASCII characters below
  741.         128 (x'80'), but treats  the special characters x'8A'  and x'8D'
  742.         as line-feed and carriage-return control characters.  Any  other
  743.         characters above 127 are treated as spaces.
  744.  
  745.            The Wrap option causes the  filtering to insure that no  line
  746.         exceeds the width of the monitor, e.g. 80 characters.
  747.  
  748.            The hex dump option (alt-H) causes the filtering to  reformat
  749.         the file  data into  a DEBUG-like  display format.   The largest
  750.         file that can be "dumped" is 1 million bytes.
  751.  
  752.            An attempt is made to retain the file position when switching
  753.         from normal to hex-dump  display, but due to  filtering changing
  754.         record lengths,  the hex  display may  begin before  the current
  755.         record.
  756.  
  757.         NOTE:   The  EOF  control character is  ignored in this version.
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.                                                         LIST     Page 13
  781.  
  782.  Update history
  783.  --------------
  784.  
  785.  There is a new version  of LIST made available frequently.  If the new
  786.  features or corrections do not interest you, stay with the version you
  787.  have. The complete version history is now kept in a another file.
  788.  
  789.  Lines beginning with | denote changes to the latest version.
  790.  
  791.         Version 6.0a thru 6.0e, August 30, 1986
  792.             - corrections to last line number
  793.             - correct disappearing EGA/EGD cursor (?)
  794.             - correct test for TopView according to Hersey
  795.             - correct display after change to 43-line mode
  796.             - correct detection of EGA number of lines
  797.  
  798.         Version 6.0f, August 31, 1986
  799.             - correct problem with 8 command, always stripping hibit
  800.  
  801. |       Version 6.0g, Sept 4, 1986
  802. |           - cosmetic corrections to Help screen
  803. |           - increase data buffer to reduce "jumpy" display
  804. |           - remove some tweaking of the cursor shape
  805. |           - default to retrace testing off (M on)
  806. |           - improve readability of binary files in ASCII display mode
  807. |             by changing handling of EOF character; this also solves
  808. |             a problem with files whose last record does not contain
  809. |             a cr/lf. Remember, LIST expects "records" to have CR and/or LF.
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.                                                         LIST     Page 14
  841.  
  842.  
  843.  Restrictions
  844.  ------------
  845.  
  846.           o  The program requires 60K bytes of memory.  If more memory
  847.              is available,  it  is  used  to store more of the file in
  848.              memory.
  849.  
  850.           o  The line number is currently limited to 65535.
  851.  
  852.           o  The  file  size  is  limited  to 16 million bytes for ASCII
  853.              files, and to 1 million bytes for hex-dump files
  854.  
  855.           o  PC-DOS Version 2.0 or later is required.
  856.  
  857.           o  ANSI.SYS is NOT required.
  858.  
  859.  
  860.         Written by Vernon Buerg for the  IBM PC using DOS 2.0 or  later,
  861.         including DOS 3.1.
  862.  
  863.         LIST  is  supplied  for  personal,  private  use.   Feel free to
  864.         distribute LIST given these restrictions:
  865.  
  866.           o  the program  shall be supplied in its original,  unmodified
  867.              form, which includes this documentation;
  868.  
  869.           o  no fee is charged.
  870.  
  871.           o  commmercial use wothout a license is prohibited.
  872.  
  873.           o  the program may not be included -  or bundled - with  other
  874.              goods or services.  Exceptions may be granted upon  written
  875.              request only.
  876.  
  877.         If you are  using LIST and  find it of  value, your gift  in any
  878.         amount  ($15  suggested)  will  be  greatly  appreciated.  Makes
  879.         checks payable to Vernon D. Buerg.  Thank you.
  880.  
  881.         For use by corporations  and other institutions, please  contact
  882.         me at AAI  Systems for a  site licensing agreement.   The source
  883.         and special licensing are also available upon request.
  884.  
  885.                 Vernon D. Buerg
  886.                 456 Lakeshire Drive
  887.                 Daly City, CA 94015-4223
  888.  
  889.                 Data:       (415) 994-2944 (VOR BBS, 24 hrs)
  890.                 Fidonet:    125/4
  891.                 Compuserve: 70007,1212
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.